home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / music_utilities / pt166.dms / pt166.adf / Utilities / MusicX-from-SMUS.doc.pp / MusicX-from-SMUS.doc
Text File  |  1978-01-02  |  4KB  |  68 lines
  1.                     MusicX-from-SMUS version 1.1
  2.            Placed in the Public Domain by MicroIllusions
  3.                 Copyright ©1990 MicroIllusions, Inc.
  4.  
  5. Introduction:
  6.     MusicX-from-SMUS is a program that converts IFF SMUS files into Music-X
  7. performances. SMUS (which stands for Simple MUsical Score) is a standard
  8. interchange format file (IFF) that is used by Amiga musical programs, such
  9. as Deluxe Music Construction Set (TM) from Electronic Arts and Sonix (TM)
  10. from Oxxi/Aegis.
  11.  
  12. How to Use:
  13.     This documentation assumes you have a working knowledge of the Amiga.
  14. If not, you may need to read the "Introduction to the Amiga" manual that
  15. came with your computer and Chapter 1 of the Music-X manual.
  16.     Double click on the MusicX-from-SMUS icon. A window will open showing
  17. file listings, although the lists will initially show all disks and logical
  18. assignments in your system. The right window is used to select the SMUS file
  19. to convert. The left window is used to select where you want the resulting
  20. Music-X file to be placed. Unless you plan to overwrite an existing Music-X
  21. performance, you will need to enter the performance file name in the Files
  22. string gadget below the left listing area.
  23.     When you have both the source SMUS file and destination Music-X file
  24. selected, click on the large left-pointing arrow. The SMUS file will then be
  25. converted. If you are overwriting a performance, the program will ask for
  26. confirmation. If the source file isn't really an IFF SMUS file, you will
  27. be told.
  28.     After the file is converted, select another file to covert (as well as
  29. a new destination performance file) or exit the program by clicking on the
  30. Close gadget in the upper left hand corner of the window.
  31.  
  32. Options:
  33.     SMUS-from-MusicX has two menus that either provide information or set
  34. various options for the conversion.
  35.     The PROJECT menu has two items: "About" and "Quit". The "About" item
  36. gives the current version number of the program. The "Quit" item has the
  37. same effect as clicking on the Close gadget.
  38.     The INSTUMENTS menu provides two options on how to convert SMUS
  39. instruments to MIDI channel or program changes. The "Remap Instruments" item
  40. will cause the converter to bring up a window asking you to decide which
  41. channels should be assigned to each named instument in the SMUS file. Once
  42. the channels have been chosen, click on this window's Close gadget to
  43. continue.  The "Use Program Changes" item tells the converter to respect
  44. program change information when an instument changes in the SMUS score. If
  45. this item is not selected, all program change information will be ignored.
  46.  
  47. Starting up from the CLI:
  48.     SMUS-from-MusicX can also be used from a Command Line Interface (CLI).
  49. The usage is:
  50.  
  51.                 SMUS-from-MusicX smusfile mxfile <REMAP> <PRGM>
  52.  
  53. The two requires parameters are the input SMUS filename and the output
  54. Music-X performance filename. The optional paramters REMAP and PRGM are
  55. equalivant to chosing the menu items "Remap Instruments" and "Use Program
  56. Changes", respectfully.
  57.  
  58. Background on SMUS Instruments:
  59.     SMUS files can either refer to instuments by MIDI channel number or by
  60. name, such as "Piano" or "SynthBass". Since Music-X only deals in MIDI
  61. infomation, named instuments must be converted to MIDI channel numbers. The
  62. default action of the converter is to assign each instument to a different
  63. channel number. When the "Remap Instruments" menu item is checked, the
  64. converter will bring up a window asking you to choose which MIDI channel
  65. number (1 to 16) will correspond to each instrument. You can choose to use the
  66. default values shown. You can also set program change information at the same
  67. time. When finished, click on the window's Close gadget.
  68.